package com.ruoyi.service;

import java.util.List;
import com.ruoyi.domain.CarCoupon;

/**
 * 商家优惠券Service接口
 * 
 * @author ruoyi
 * @date 2025-01-27
 */
public interface ICarCouponService 
{
    /**
     * 查询商家优惠券
     * 
     * @param id 商家优惠券主键
     * @return 商家优惠券
     */
    public CarCoupon selectCarCouponById(Integer id);

    /**
     * 查询商家优惠券列表
     * 
     * @param carCoupon 商家优惠券
     * @return 商家优惠券集合
     */
    public List<CarCoupon> selectCarCouponList(CarCoupon carCoupon);

    /**
     * 根据商家ID查询优惠券列表
     * 
     * @param merchantId 商家ID
     * @return 优惠券列表
     */
    public List<CarCoupon> selectCarCouponByMerchantId(Integer merchantId);

    /**
     * 查询可领取的优惠券列表
     * 
     * @return 优惠券列表
     */
    public List<CarCoupon> selectAvailableCoupons();

    /**
     * 新增加商家优惠券
     * 
     * @param carCoupon 商家优惠券
     * @return 结果
     */
    public int insertCarCoupon(CarCoupon carCoupon);

    /**
     * 修改商家优惠券
     * 
     * @param carCoupon 商家优惠券
     * @return 结果
     */
    public int updateCarCoupon(CarCoupon carCoupon);

    /**
     * 批量删除商家优惠券
     * 
     * @param ids 需要删除的商家优惠券主键集合
     * @return 结果
     */
    public int deleteCarCouponByIds(Integer[] ids);

    /**
     * 删除商家优惠券信息
     * 
     * @param id 商家优惠券主键
     * @return 结果
     */
    public int deleteCarCouponById(Integer id);

    /**
     * 领取优惠券
     * 
     * @param couponId 优惠券ID
     * @param userId 用户ID
     * @return 结果
     */
    public int receiveCoupon(Integer couponId, Integer userId);

    /**
     * 使用优惠券
     * 
     * @param couponId 优惠券ID
     * @param userId 用户ID
     * @return 结果
     */
    public int useCoupon(Integer couponId, Integer userId);

    /**
     * 检查优惠券是否可用
     * 
     * @param couponId 优惠券ID
     * @param amount 订单金额
     * @return 是否可用
     */
    public boolean isCouponAvailable(Integer couponId, Double amount);
}
